home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 641 / docs / m1bm_doc.mnu < prev    next >
Text File  |  1992-11-07  |  52KB  |  1,546 lines
  1. #:main
  2.  ************************************
  3.  ******  KORG M1 Bank Manager  ******
  4.  ************************************
  5. 0:-
  6.  
  7. +| * Introduction           *
  8. =:intro
  9. +| * The Menus              *
  10. =:menus
  11. +| * The Icons              *
  12. =:icons
  13. +| * Using the Mouse        *
  14. =:mouse
  15. +| * Using the Keyboard     *
  16. =:keyboard
  17. +| * Limitations            *
  18. =:limitations
  19. +| * Disclaimer             *
  20. =:disclaimer
  21. +| * Copyright              *
  22. =:copyright
  23. +| * Final Remarks          *
  24. =:final
  25.  
  26. /
  27. /
  28. #:help
  29. U|How to use this documentation program
  30.  
  31. Use the arrow keys or mouse to move around in the menus:
  32.  
  33. Up/down arrow or mousepointer selects the various menu entries.
  34. Right arrow/left mousebutton/Return selects an entry ('pops in').
  35. Left arrow/right mousebutton/Undo jumps to previous menu ('pops out').
  36. ClrHome always brings you to the main menu.
  37. Escape always exits the program.
  38. Help brings up this menu.
  39.  
  40. Now press the right mousebutton or the left arrow to go back to where
  41. you came from...
  42.  
  43. /
  44. /
  45. #:intro
  46. U|Introduction
  47. T:¯
  48. The M1 Bank Manager -M1_BANKS.PRG- is meant to be a very flexible
  49. librarian that will help you organize all those M1-patches you so
  50. carefully designed. You are now able to maintain libraries of M1
  51. patches (Programs) and multi-timbral setups (Combinations), save
  52. them to disk, dump them to your M1, perform System-Exclusive dumps
  53. of all M1 parameters and lots more.
  54. In fact the program consists of two separate librarians - a Program
  55. librarian and a Combination librarian. Since both operate in exactly
  56. the same way, this document will only mention 'sounds' or 'programs',
  57. always meaning 'sounds', 'programs' or 'combinations'. Read the
  58. chapter 'The Menus / Mode' to learn more about switching from one
  59. librarian to the other. Note that when switching from one librarian
  60. to the other, the appropriate menu-entries change accordingly; e.g.
  61. 'Send Sound(s)' in Program Mode becomes 'Send Combi(s)' when in
  62. Combinaton mode. So when talking about the menu-entry 'Send Sound(s)'
  63. we always intend to mean -both- versions of the entry.
  64.  
  65. +:Next page...
  66. =:intro2
  67. /
  68. /
  69. #:intro2
  70. Since the program is so flexible, some things may not be clear at first
  71. sight. Therefore it is highly recommended that you read this documentation
  72. before using the program. Since many users often don't have the patience to
  73. 'read before doing', you should at least read the following section, in
  74. order not to lose valuable data (e.g. that patch you've just finished after
  75. days of blood, sweat and tears).
  76.  
  77. Before doing anything else (except for reading this document of course),
  78. you should make a backup of all your M1-data. The next steps are involved:
  79. - Turn on your M1 and be sure it's properly connected to your ST (i.e.
  80.   MIDI INs and OUTs *both* connected).
  81. - Start the program M1_BANKS.PRG.
  82. - Go to the '--M1--' menu and select the option 'M1 to Disk'.
  83. - In the dialog that now appears, click on 'All'.
  84. - After a while the fileselector appears. Type in a name for the backup-
  85.   files to be saved, e.g. 'BACKUP'. There's no need to provide an extension
  86.   for the file - the program will take care of that.
  87. - You now have a backup of your M1 data, split in 4 different files. If you
  88.   want to know how to restore those data (i.e. send them to the M1), read
  89.   the chapter 'The Menus / --M1-- / Disk to M1'.
  90.  
  91. +:Next page...
  92. =:intro3
  93. /
  94. /
  95. #:intro3
  96. A last remark before we get to the 'real worx'. You should understand the
  97. basic concept of the program. The desktop contains 100 slots which
  98. correspond to the 100 programs of combinations in the M1. Slots can contain
  99. sounds and can be saved, sent etc. So a 'soundslot' is sort of the basic
  100. unit for the program. For that reason it is not possible to make libraries
  101. containing more than 100 sounds. Restrictive, you say? No, just maintain
  102. different libraries with different kinds of sounds - this will be far more
  103. comprehensible than one big library with 1000+ sounds.
  104. Since a slot is 'what's being acted upon', most of the operations require
  105. you to *select* the slots you want the operation to have an effect on.
  106. Selecting a slot is accomplished by clicking on it, or shift-dragging to
  107. select multiple slots. Whenever an operation doesn't seem to have any
  108. effect, be sure there are (non-empty) slots selected.
  109.  
  110. +:Next page...
  111. =:intro4
  112. /
  113. /
  114. #:intro4
  115. The program knows various kinds of actions: you can select a menu-item,
  116. you can use the mouse to drag, click or double-click various elements in
  117. the desktop, lots of commands can be invoked by pressing a certain key-
  118. combination and using the desktop-icons can considerably speed up many
  119. actions. Therefore we split this manual in sections corresponding to
  120. those various 'action fields':
  121.  
  122. +| * The Menus              *
  123. =:menus
  124. +| * The Icons              *
  125. =:icons
  126. +| * Using the Mouse        *
  127. =:mouse
  128. +| * Using the Keyboard     *
  129. =:keyboard
  130. +| * Limitations            *
  131. =:limitations
  132. +| * Disclaimer             *
  133. =:disclaimer
  134. +| * Copyright              *
  135. =:copyright
  136. +| * Final Remarks          *
  137. =:final
  138.  
  139. /
  140. /
  141. #:menus
  142. U|The Menus
  143. T:¯
  144.  
  145. +| *        File            *
  146. =:file
  147. +| *        Edit            *
  148. =:edit
  149. +| *        --M1--          *
  150. =:m1
  151. +| *        Options         *
  152. =:options
  153. +| *        Mode            *
  154. =:mode
  155. +| *        Safety          *
  156. =:safety
  157. +| *        Help            *
  158. =:on help
  159.  
  160. /
  161. /***************** FILE MENU ********************************
  162. /
  163. #:file
  164. U|File menu
  165. T:¯
  166. +: New
  167. =:new
  168. +: Open
  169. =:open
  170. +: Open with pos
  171. =:openpos
  172. +: Open & Set
  173. =:openset
  174. +: Save
  175. =:save
  176. +: Save Settings
  177. =:saveset
  178. +: Print Desktop
  179. =:printdt
  180. +: Print Library
  181. =:printlib
  182. +: Printer Settings
  183. =:printset
  184. +: Delete File
  185. =:delete file
  186. +: Quit
  187. =:quit
  188.  
  189. /
  190. /
  191. #:new
  192. U|New
  193. T:¯
  194. Erases all the sounds in the desktop. If 'Safety/Deletes' is checked, you
  195. will be asked to confirm this operation. If 'Options/Auto Deselect' is
  196. checked, all selected slots will be deselected.
  197.  
  198. +:Open...
  199. =:open
  200. +:Back to The Menus...
  201. =:menus
  202. /
  203. /
  204. #:open
  205. U|Open
  206. T:¯
  207. Opens a library. Program libraries are files with an extension MPR (i.e.
  208. M1 PR'ograms), combination libraries have an extension MCO (...). The file-
  209. selector will appear with the appropriate files shown, depending on whether
  210. you're in Program-mode or in Combination-mode. Select the library you want
  211. to load, and click OK. When you enter the name of the file by hand, you need
  212. not type the extension, since the program does that for you. Also the
  213. program won't allow you to load files with non-valid extensions.
  214. Note that 'Open' works as a 'merge': sounds already present are not
  215. automatically deleted when loading a new file.
  216. When you press one of the SHIFT keys while selecting 'Open', the file-
  217. selector will show *both* the libraries (i.e. MPR or MCO files) *and* the
  218. backup-files (MPB and MCB - see 'Safety/Backups'). This way you're able to
  219. load backups of libraries. This is the one exception to the rule that the
  220. program won't allow you to load other files than MPR/MCO files...
  221.  
  222. +:Open with pos...
  223. =:openpos
  224. +:Back to The Menus...
  225. =:menus
  226. /
  227. /
  228. #:openpos
  229. U|Open with pos
  230. T:¯
  231. Also opens a library.  The slots where the sounds were located last time you
  232. saved the library are saved with the library. 'Open with pos' now loads the
  233. sounds in a library back to those positions.
  234. Be careful, as you might overwrite sounds already present in the desktop.
  235.  
  236. +:Open & Set...
  237. =:openset
  238. +:Back to The Menus...
  239. =:menus
  240. /
  241. /
  242. #:openset
  243. U|Open & Set
  244. T:¯
  245. Opens a library. You are presented with a dialog in which all the sounds
  246. of the file can be seen (and selected). You can choose between loading all
  247. sounds or loading only the sounds you've selected. Furthermore you can
  248. choose between loading the sounds to the first free positions on the desk-
  249. top (Free), to adjacent positions, starting from the first selected desktop-
  250. position (Adjacent), to exactly the selected desktop-positions (Selected),
  251. or to the positions that were stored with the file (Positions). The settings
  252. you make in this dialog will affect all further 'File/Open' operations!
  253. At first sight the many different possibilities may be a bit confusing. Play
  254. around with them until you fully understand what the effect of all those
  255. possibilities is - you'll soon discover how flexible they make the program.
  256. Upon startup the default settings for 'Open & Set' is 'Load All - Load to
  257. Free'. This causes the 'Open & Set' command to work exactly like the 'Open'
  258. command: opened files are merged with sounds already present in the desktop.
  259.  
  260. +:Save...
  261. =:save
  262. +:Back to The Menus...
  263. =:menus
  264. /
  265. /
  266. #:save
  267. U|save
  268. T:¯
  269. Saves all selected sounds - and **only** the selected sounds! The desktop-
  270. position is stored with the sounds and can be retrieved with the 'File/Open
  271. with pos' menu-option. When entering a name for the file to be saved in the
  272. fileselector, there is no need to supply an extension as the program takes
  273. care of that. When in Program mode, files will be saved with the extension
  274. MPR. In Combination mode the extension is MCO.
  275. If you haven't selected any sounds, nothing will be saved (so no 0 byte file
  276. is created) and you will be told that nothing is saved.
  277. If you try to save a file that already exists and the 'Safety/Backup' menu-
  278. item is checked, the already existing file will be renamed - extension MPR
  279. is changed in MPB, MCO is changed in MCB - before the sounds are saved. In
  280. case the 'Backup'-safety is switched off, you will be notified of already
  281. existing files and warned that they will be overwritten if you proceed. You
  282. may now choose to 'Overwrite', 'Backup' or completely 'Cancel' the
  283. operation.
  284.  
  285. +:Save Settings...
  286. =:saveset
  287. +:Back to The Menus...
  288. =:menus
  289. /
  290. /
  291. #:saveset
  292. U|Save Settings
  293. T:¯
  294. Stores various settings in the M1_BANKS.DAT file. This file contains the
  295. printer settings, the 'Autoplay' settings & flag, 'Auto Deselect' flag,
  296. 'Double Check Data' flag, 'Invert SHIFT-key' flag, the default paths
  297. (Options/Set Default Paths), the desktop color, the settings made in the
  298. 'Mode' menu and all the safety flags. Next time you start the program it
  299. will read this file and restore all your preferred settings.
  300. Note to version 1.x users of the program: the Clipboard settings and 'File/
  301. Open & Set' settings are no longer stored in the settings-file. Instead
  302. both dialogs now default to 'All - To Free' when starting the program.
  303.  
  304. +:Print Desktop...
  305. =:printdt
  306. +:Back to The Menus...
  307. =:menus
  308. /
  309. /
  310. #:printdt
  311. U|Print Desktop
  312. T:¯
  313. Prints the names of the sounds that are viewed in the desktop. Output is
  314. sent to the printer or to a file, depending on the settings made in the
  315. 'Printer Settings' dialog. Page-layout is also determined by the settings
  316. made in this dialog. When printing to a file, a fileselector will ask you
  317. to enter the name of the output file. This output file is a normal ASCII
  318. text-file that can be edited with any text-editor or wordprocessor. When
  319. printed to disk, a listing will have the extension LST - there's no need
  320. to type in an extension yourself.
  321.  
  322. +:Print Library...
  323. =:printlib
  324. +:Back to The Menus...
  325. =:menus
  326. /
  327. /
  328. #:printlib
  329. U|Print Library
  330. T:¯
  331. Prints the contents of a library (MPR or MCO file). Again, page-layout and
  332. whether you print to disk or to the printer is determined by the settings
  333. made in the 'Printer Settings' dialog. A fileselector will ask you to select
  334. the library to print. When printing to a file, the fileselector will appear
  335. once more. Now enter the name of the output file - the program will auto-
  336. matically give it the extension LST.
  337.  
  338. +:Printer Settings...
  339. =:printset
  340. +:Back to The Menus...
  341. =:menus
  342. /
  343. /
  344. #:printset
  345. U|Printer Settings
  346. T:¯
  347. Allows you to adjust printer-output. The settings made here are used
  348. whenever output is being sent to the printer, whether you 'Print Desktop',
  349. 'Print Library' or direct the output of 'Options/Find Sound' to the printer.
  350. You can adjust page-size, left, right, top and bottom margins. Next you can
  351. choose whether to have the program send a formfeed after each page, or if
  352. you use continous paper (in which case the output won't be split into
  353. pages). The last option is to have the output be redirected to disk instead
  354. of the printer. If this is selected, every command resulting in printer-
  355. output will invoke a fileselector, in which you can enter the name of the
  356. output-file. Output files are plain ASCII files that can be edited with any
  357. text-editor or word-processor. The settings made in this dialog will be
  358. saved in the M1_BANKS.DAT file when you 'Save Settings'.
  359.  
  360. +:Delete File...
  361. =:delete file
  362. +:Back to The Menus...
  363. =:menus
  364. /
  365. /
  366. #:delete file
  367. U|Delete File
  368. T:¯
  369. When you run out of disk space, this enables you to get rid of unneeded
  370. files (e.g. backup files). The fileselector is invoked in which you can
  371. select the file to be deleted. An alert will ask you if you're sure you
  372. want to delete this file. Clicking OK will send the file to the eternal
  373. Nirvana of Bits...
  374.  
  375. +:Quit...
  376. =:quit
  377. +:Back to The Menus...
  378. =:menus
  379. /
  380. /
  381. #:quit
  382. U|Quit
  383. T:¯
  384. Pretty obvious I think. If the 'Safety/Changes' item is checked, and you
  385. have made changes to the desktop since you last saved your work, you will
  386. be notified of this and asked if you're sure you want to quit.
  387.  
  388. +:*   Edit Menu...   *
  389. =:edit
  390. +:Back to The Menus...
  391. =:menus
  392. /
  393. /***************** EDIT MENU ********************************
  394. /
  395. #:edit
  396. U|Edit menu
  397. T:¯
  398. +: Cut
  399. =:cut
  400. +: Copy
  401. =:copy
  402. +: Add
  403. =:add
  404. +: Paste
  405. =:paste
  406. +: Swap
  407. =:swap
  408. +: Delete
  409. =:delete
  410. +: Remove
  411. =:remove
  412. +: Insert
  413. =:insert
  414. +: Select All
  415. =:sel all
  416. +: Deselect All
  417. =:desel all
  418. +: Clipboard Clear
  419. =:clip clear
  420. +: Clipboard Set
  421. =:clip set
  422.  
  423. /
  424. /
  425. #:cut
  426. U|Cut
  427. T:¯
  428. The Bank Manager uses a very versatile clipboard, to which sounds can be
  429. copied and from which sounds can be pasted back to the desktop again. The
  430. clipboard can contain up to 100 sounds, just like the desktop. Making good
  431. use of the clipboard can speed up things considerably. The clipboard gives
  432. you the possibility to manipulate up to 200 sounds at the same time - 100
  433. on the desktop and another 100 on the clipboard.
  434.  
  435. The 'Cut' command first *clears* the entire clipboard and then moves the
  436. selected sounds to it - i.e. the selected sounds are removed from the
  437. desktop! Empty selected slots are simply ignored, so when the desktop is
  438. not completely filled and you want to Cut all the sounds to the clipboard,
  439. simply 'Select All' sounds and 'Cut' - you need not be afraid the clipboard
  440. will contain all those empty slots.
  441.  
  442. +:Copy...
  443. =:copy
  444. +:Back to The Menus...
  445. =:menus
  446. /
  447. /
  448. #:copy
  449. U|Copy
  450. T:¯
  451. Just like with 'Cut', the clipboard is cleared and the selected sounds are
  452. copied to it. When 'Copy'-ing however, the original sounds will *not* be
  453. removed from the desktop. Again, selected slots that are empty will be
  454. ignored.
  455.  
  456. +:Add...
  457. =:add
  458. +:Back to The Menus...
  459. =:menus
  460. /
  461. /
  462. #:add
  463. U|Add
  464. T:¯
  465. Adds sounds to the clipboard, without first clearing it. The sounds are not
  466. removed from the desktop. So this one works just like 'Copy' except that the
  467. clipboard is not cleared. Selected empty slots are ignored, as usual.
  468.  
  469. +:Paste...
  470. =:paste
  471. +:Back to The Menus...
  472. =:menus
  473. /
  474. /
  475. #:paste
  476. U|Paste
  477. T:¯
  478. Some or all of the sounds on the clipboard are copied to the desktop. Since
  479. the clipboard is *not* cleared, the same set of sounds can be pasted various
  480. times. The way in which the paste-function works depends on the settings
  481. made in the 'Edit/Set Clipboard' dialog.
  482.  
  483. +:Swap...
  484. =:swap
  485. +:Back to The Menus...
  486. =:menus
  487. /
  488. /
  489. #:swap
  490. U|swap
  491. T:¯
  492. The mouse changes to a pointing finger. After pointing & (left-) clicking
  493. on two sounds, those sounds are swapped. Right clicking or hitting any key
  494. aborts the operation. This allows for fast rearranging of sounds. You may
  495. also 'Swap' an empty slot and a non-empty slot (of course you may also
  496. swap two empty slots, but that's hardly useful...). Right-clicking aborts
  497. the operation.
  498.  
  499. +:Delete...
  500. =:delete
  501. +:Back to The Menus...
  502. =:menus
  503. /
  504. /
  505. #:delete
  506. U|delete
  507. T:¯
  508. Deletes all selected sounds in the desktop. If 'Safety/Deletes' is checked
  509. you are asked to confirm this operation. After the Delete operation you'll
  510. have some new empty slots - provided you did select some non-empty slots
  511. to delete of course...
  512.  
  513. +:Remove...
  514. =:remove
  515. +:Back to The Menus...
  516. =:menus
  517. /
  518. /
  519. #:remove
  520. U|Remove
  521. T:¯
  522. The mouse changes to a pointing finger. When you left-click on a sound it
  523. is deleted and all sounds above this one are moved one position down, so
  524. that no empty slot arises. Right-click or press any key to abort this
  525. operation.
  526.  
  527. +:Insert...
  528. =:insert
  529. +:Back to The Menus...
  530. =:menus
  531. /
  532. /
  533. #:insert
  534. U|Insert
  535. T:¯
  536. The opposite of Remove: left clicking on a slot moves all following sounds
  537. one position up, so that an empty slot is created. Right-click or press
  538. any key to abort this operation. Be careful: since *all* slots are moved up
  539. -including the empty ones- slot 99 (the last one) will 'fall off' the
  540. desktop. Be sure it is empty, or that you don't mind losing the sound that
  541. is stored in it.
  542.  
  543. +:Select All...
  544. =:sel all
  545. +:Back to The Menus...
  546. =:menus
  547. /
  548. /
  549. #:sel all
  550. U|Select All
  551. T:¯
  552. Selects all 100 slots. Pretty straightforward, isn't it. Read the chapter
  553. on 'Using the Keyboard' to learn how you can select blocks of 20 sounds
  554. very fast by means of the Function Keys.
  555.  
  556. +:Deselect All...
  557. =:desel all
  558. +:Back to The Menus...
  559. =:menus
  560. /
  561. /
  562. #:desel all
  563. U|Deselect All
  564. T:¯
  565. Deselects all 100 slots. Again pretty straightforward. Read the chapter
  566. on 'Using the Keyboard' to learn how you can deselect blocks of 20 sounds
  567. very fast by means of the Function Keys.
  568.  
  569. +:Clear Clipboard...
  570. =:clip clear
  571. +:Back to The Menus...
  572. =:menus
  573. /
  574. /
  575. #:clip clear
  576. U|Clear Clipboard
  577. T:¯
  578. Clears the clipboard completely. Selecting 'Cut' or 'Copy' while no sounds
  579. are selected has the same effect. I don't know if this is really useful,but
  580. it was very easy to incorporate, so...
  581.  
  582. +:Set Clipboard...
  583. =:clip set
  584. +:Back to The Menus...
  585. =:menus
  586. /
  587. /
  588. #:clip set
  589. U|Set Clipboard
  590. T:¯
  591. Brings up the clipboard-dialog. Here you can determine how the 'Paste'-
  592. function will work. It is possible to paste only the selected sounds, or
  593. all sounds present on the clipboard. Furthermore you can choose between
  594. pasting to the first free positions (Free), to adjacent positions,
  595. starting at the first selected sound (Adjacent), or pasting to precisely
  596. the selected slots (Selected). This dialog is remarkably similar to the
  597. 'File/Open & Set' dialog... :-) - except for the now missing 'Positions'-
  598. button. Upon startup this dialog defaults to 'Paste All to Free' - the
  599. standard Paste behaviour. In addition to the file-dialog there is one extra
  600. button, named 'Delete'. Clicking this button will delete all selected
  601. sounds. This way you're able to 'selectively' clear the clipboard. When
  602. deleting sounds from the clipboard, no confirmation is asked, *even if the
  603. 'Safety/Deletes' item is checked*.
  604.  
  605. +:*   M1 Menu...   *
  606. =:m1
  607. +:Back to The Menus...
  608. =:menus
  609. /
  610. /***************** M1 MENU ********************************
  611. /
  612. #:m1
  613. U|M1 menu
  614. T:¯
  615. +: Receive Sound(s)
  616. =:receive
  617. +: Send Sound(s)
  618. =:send
  619. +: Disk to M1
  620. =:disk-m1
  621. +: M1 to disk
  622. =:m1-disk
  623. +: Hear Sound
  624. =:hear sound
  625. +: Autoscan
  626. =:autoscan
  627. +: Global Channel
  628. =:global
  629.  
  630. /
  631. /
  632. #:receive
  633. U|Receive Sound(s)
  634. T:¯
  635. The program will start sending program dump requests to the M1. The received
  636. programs are those that correspond to the selected slots in the desktop.
  637. If an error is encountered while receiving data from the M1, you will be
  638. notified that there was an 'error receiving sound xx' and asked if you want
  639. to 'Retry', 'Skip' or 'Quit'. Retrying will send the same dump request
  640. again, 'Skip' will proceed to the next selected slot and 'Quit' will abort
  641. the receive-operation altogether.
  642.  
  643. +:Send Sound(s)...
  644. =:send
  645. +:Back to The Menus...
  646. =:menus
  647. /
  648. /
  649. #:send
  650. U|Send Sound(s)
  651. T:¯
  652. All selected sounds are sent *and written* to the M1. If 'Safety/Sending'
  653. is checked you are asked to confirm this operation. Dump errors are treated
  654. just as when receiving sounds.
  655.  
  656. +:Disk to M1...
  657. =:disk-m1
  658. +:Back to The Menus...
  659. =:menus
  660. /
  661. /
  662. #:disk-m1
  663. U|Disk to M1
  664. T:¯
  665. Enables you to send data directly from disk to the M1. This data should be
  666. stored with the 'M1/M1 to Disk' menu-option. You may send Program data,
  667. Combi data, Sequencer data, Global data or 'All'-data. When doing an 'All
  668. Data' dump, the program asks you to select a program-data file (.PRO) and
  669. then starts looking for other files with the same name, but with extensions
  670. corresponding to the different data-types (COM for combinations, SEQ for
  671. sequencer data and GLO for global data). All files that are found are sent
  672. to the M1. Note that these files contain raw Sys-Ex dumps, so it may be
  673. possible to send files that are made with another librarian, using this
  674. option (since some librarians are able to write Sys-Ex files).
  675. Note also that when doing an 'All Data' dump, if files are missing (e.g. you
  676. only have SETUP.PRO and SETUP.GLO, but SETUP.COM and SETUP.SEQ are missing),
  677. you will be notified, but the program will still be able to send the files
  678. it *did* find - the Program and Global files in this example.
  679.  
  680. +:M1 to Disk...
  681. =:m1-disk
  682. +:Back to The Menus...
  683. =:menus
  684. /
  685. /
  686. #:m1-disk
  687. U|M1 to Disk
  688. T:¯
  689. Performs a Sys-Ex dump of the desired data. The data is written directly to
  690. disk. You can choose between Program, Combi, Sequencer, Global and All data.
  691. When an 'All-data dump' is performed, the program creates 4 different files
  692. (one per data-type), all with the same name, but with different extensions
  693. (PRO, COM, SEQ and GLO respectively). The reason for not implementing a real
  694. 'all data' dump, is that it's easier to retrieve particular data this way.
  695. You could e.g. do an 'All Data' dump, save the dump as SETUP.XXX (4 files)
  696. and later decide to restore only the program-data by sending ('Disk to M1')
  697. just the SETUP.PRO file
  698. Note that those Sys-Ex files can *not* be loaded into the Bank Manager by
  699. 'Open'-ing a file!
  700. You could use those dumps to make fast backups of your current settings, or
  701. to maintain different drum-maps (which are part of the Global-data). Another
  702. application is using the sequence-dump to store sets of drum-patterns you
  703. made with the M1-sequencer.
  704.  
  705. +:Hear Sound...
  706. =:hear sound
  707. +:Back to The Menus...
  708. =:menus
  709. /
  710. /
  711. #:hear sound
  712. U|Hear Sound
  713. T:¯
  714. The mouse changes to a pointing finger and after left-clicking on a non-
  715. empty slot, the sound is sent to the M1, but *not* written. A keyboard
  716. appears on the screen and the mouse changes to a note. Left-licking anywhere
  717. sends a note-on to the M1. Up/down determines volume (velocity) while left/
  718. right determines pitch. Anywhere during this operation right-clicking or
  719. hitting any key aborts. This option is especially handy when you want to
  720. inspect a sound while your M1 is on the other side of the room.
  721.  
  722. +:Autoscan...
  723. =:autoscan
  724. +:Back to The Menus...
  725. =:menus
  726. /
  727. /
  728. #:autoscan
  729. U|Autoscan
  730. T:¯
  731. When you select 'Autoscan' the program will send the first selected sound
  732. to the M1 (*without* writing it) and play a note as specified by the auto-
  733. play-settings (c.f. 'Options/Set Autoplay'). Only the duration is not taken
  734. into account: the note will play until you hit a key or mousebutton. Then
  735. the next selected sound will be sent to the M1 and the process repeats.
  736. This way it's very easy to get a quick overview of the sounds in the desk-
  737. top. The operation can be aborted by pressing the right mousebutton (left
  738. continues) or Control-Z.
  739.  
  740. +:Global Channel...
  741. =:global
  742. +:Back to The Menus...
  743. =:menus
  744. /
  745. /
  746. #:global
  747. U|Global Channel
  748. T:¯
  749. At startup-time the programs tries to determine the M1's global channel.
  750. If this somehow fails, or you've changed it in the meantime, you can
  751. (re-)enter it here. Selecting the 'Receive Global Channel'-button lets
  752. the program try once more to retrieve the global channel from the M1.
  753. Since all communication with the M1 is through the global channel, it
  754. is very important that it is entered correctly.
  755. In general you don't have to worry about the global channel setting,
  756. since before performing a dump (Sending) or requesting a dump (Receiving)
  757. the program checks if the global channel setting is still correct.
  758. This check is not performed when 'Autoplay'-ing a sound.
  759.  
  760. +:*   Options Menu...   *
  761. =:options
  762. +:Back to The Menus...
  763. =:menus
  764. /
  765. /***************** OPTIONS MENU ********************************
  766. /
  767. #:options
  768. U|Options menu
  769. T:¯
  770. +: Autoplay
  771. =:autoplay
  772. +: Set Autoplay
  773. =:set autoplay
  774. +: Auto Deselect
  775. =:auto deselect
  776. +: Double Check Data
  777. =:double check
  778. +: Invert SHIFT-key
  779. =:invert shift
  780. +: Find Sound
  781. =:find sound
  782. +:Sort Sounds
  783. =:sort sounds
  784. +: Set Default Paths
  785. =:default paths
  786. +: Desktop Color
  787. =:desktop
  788.  
  789. /
  790. /
  791. #:autoplay
  792. U|Autoplay
  793. T:¯
  794. If this option is checked, every time you select a sound in the desktop,
  795. the sound is sent to the M1 (but not written!!) and a note is played.
  796. Pitch, duration and length of the note being played are determined by
  797. the 'Set Autoplay' settings.
  798. The Autoplay-flag is saved when you 'Save Settings'.
  799.  
  800. +:Set Autoplay...
  801. =:set autoplay
  802. +:Back to The Menus...
  803. =:menus
  804. /
  805. /
  806. #:set autoplay
  807. U|Set Autoplay
  808. T:¯
  809. Here you can determine what note (pitch) is sent at what volume
  810. (velocity) for how long, when you select a sound and 'Autoplay'
  811. is checked. The pitch, velocity and duration settings are saved
  812. when you 'Save Settings'.
  813.  
  814. +:Auto Deselect...
  815. =:auto deselect
  816. +:Back to The Menus...
  817. =:menus
  818. /
  819. /
  820. #:auto deselect
  821. U|Auto Deselect
  822. T:¯
  823. If this options is checked, all selected sounds are automatically
  824. deselected when saving/sending/receiving/pasting/etc., etc.
  825. The 'Auto Deselect'-flag is saved when you 'Save Settings'.
  826.  
  827. +:Double Check Data...
  828. =:double check
  829. +:Back to The Menus...
  830. =:menus
  831. /
  832. /
  833. #:double check
  834. U|Double Check Data
  835. T:¯
  836. Sometimes when receiving data from the M1 it gets corrupted. This problem
  837. does not occur (as far as I know) when sending data to the M1. If you want
  838. to be very sure that all data arrives properly, you can have the program
  839. double check the data, by checking this option. Note that data integrity
  840. is nearly 100% guaranteed when 'Double Check'ing...
  841. Be warned: receiving data takes up more time when 'double checked' (2 times
  842. as long typically), but on the other hand... what's more important: safety
  843. or speed...? You are adviced to have this option turned on.
  844. The 'Double Check Data' flag is also part of the settings that can be
  845. saved.
  846.  
  847. +:Invert SHIFT-key...
  848. =:invert shift
  849. +:Back to The Menus...
  850. =:menus
  851. /
  852. /
  853. #:invert shift
  854. U|Invert SHIFT-key
  855. T:¯
  856. You can select multiple sounds by pressing either SHIFT-key while dragging
  857. the mouse. When not holding down a SHIFT-key, dragging will pick up the
  858. selected sounds and move/copy them to an icon or to another location in the
  859. 'soundbox' (the 100-slot box).
  860. When you find you use the 'drag-select' more often than the 'drag-move',
  861. you can reverse the operation of the SHIFT-keys by checking this menu-item.
  862. Now normal dragging will multi-select sounds, while drag&SHIFT will move/
  863. copy sounds. More on this can be found in the chapter 'Using the Mouse'.
  864. The 'Invert SHIFT-key' flag is saved when you 'Save Settings'.
  865.  
  866. +:Find Sound...
  867. =:find sound
  868. +:Back to The Menus...
  869. =:menus
  870. /
  871. /
  872. #:find sound
  873. U|Find Sound
  874. T:¯
  875. This is one of the more sophisticated -and complicated- features of the
  876. program. Suppose you know you have this wonderful patch of some stringbass
  877. sound, but you don't know exactly how it was called or in which library
  878. you stored it. You only know it was something like 'Bass String' or
  879. 'Bass str.' or maybe 'SynBasStr'... Now it would be a pain to have to
  880. search through all your libraries - or at least the Bass, Strings and Synth
  881. libraries. This is where 'Find Sound' can help you.
  882.  
  883. What it does is scan all available libraries for a specific sound - but
  884. except for looking for a specific sound (e.g. BassString), you may also
  885. use wildcards in the name you specify, so the program tries to match all
  886. library-sounds with the search pattern you provided.
  887.  
  888. +:Next Page...
  889. =:find2
  890. /
  891. /
  892. #:find2
  893. In the dialog you enter the name of the sound you're looking for - and if
  894. the 'wildcards'-button is selected you may also use '*' to match any number
  895. of characters, or '?' to match exactly one character (the 'Ignore Case' and
  896. 'Ignore Blanks' do exactly what you expect them to do and you are advised
  897. to have them always turned on - except for when you're _sure_ the sound
  898. you're looking for is 'synth bass' and not 'SynthBass'...).
  899. In the example given above, you might enter '*bas*str*' - the program will
  900. now find 'SynBasStr', 'BassString', 'basstring', 'Base STRONG', etc.
  901. Searching for *str?ng*' will find 'string', 'Strings', 'SoftString',
  902. 'LoStrings1', 'strong', 'STRONGbass', 'So Strange, etc., but not 'strng',
  903. 'Striiing', or 'streaming'.
  904. Searching for '*' will find *all* sounds. The reason you may turn the
  905. 'wildcards' option off is obvious: suppose you're looking for a sound
  906. called '*' ...
  907.  
  908. +:Next Page...
  909. =:find3
  910. /
  911. /
  912. #:find3
  913. In the Find-dialog you may also choose whether output should be sent to the
  914. printer, to the screen or both. When output is sent to the screen and a
  915. matching sound is found, a dialog will appear. It will tell which sound was
  916. found and in which library (e.g. 'Sound 12: BassString in file STRINGS.MPR'),
  917. and you can choose between 'load the sound and continue the search',
  918. 'continue the search (without loading the currently found sound)', 'load the
  919. sound and stop the search', or 'stop searching (without loading the current
  920. sound)'. When loading a sound it is always loaded to the first free slot in
  921. the desktop.
  922. When directing output to the printer, the settings made in 'File/Printer
  923. Settings' apply. This means that you may also redirect output to a file,
  924. by selecting the 'Output to File' option in the printer-settings dialog.
  925. If you want a file with the complete contents of all your libraries, you
  926. could set the printer-settings to 'output to file', then go to the 'Find
  927. Sound' dialog, select 'output to printer' and search for '*' (while
  928. 'wildcards' is enabled of course)... Files that are the result of a 'Find
  929. Sound' operation have the extension FND.
  930. Note!: 'Find Sound' only scans the default folder, set in the 'Set Default
  931. Paths' dialog, or the last folder you selected when using the fileselector.
  932.  
  933. +:Sort Sounds...
  934. =:sort sounds
  935. +:Back to The Menus...
  936. =:menus
  937. /
  938. /
  939. #:sort sounds
  940. U|Sort Sounds
  941. T:¯
  942. This one sorts _all_ available sounds (so _not_ just the selected
  943. ones) in alphabetical order. The fastest way to get a contiguous set
  944. of sounds (i.e. without empty slots in between) is by 'Sort'-ing them.
  945.  
  946. +:Set Default Paths...
  947. =:default paths
  948. +:Back to The Menus...
  949. =:menus
  950. /
  951. /
  952. #:default paths
  953. U|Set Default Paths
  954. T:¯
  955. Here you enter the folders where you've stored your sound files (MPR),
  956. combination files (MCO) and sys-ex files (PRO, COM, GLO, SEQ, generated
  957. with 'M1 to Disk'). Clicking one of the boxes in front of the paths brings
  958. up the fileselector in which you now move to the desired folder. Select OK
  959. in the fileselector to copy the path to the dialog. Select OK in the dialog
  960. to install the paths.
  961. These paths are saved when you 'Save Settings'.
  962.  
  963. +:Desktop Color...
  964. =:desktop
  965. +:Back to The Menus...
  966. =:menus
  967. /
  968. /
  969. #:desktop
  970. U|Desktop Color
  971. T:¯
  972. Change the desktop color if you want! The color will be saved in the
  973. settings file M1_BANKS.DAT if you 'Save Settings'. Can't say this program
  974. ain't flexibel, can you...?
  975.  
  976. +:*   Mode Menu...   *
  977. =:mode
  978. +:Back to The Menus...
  979. =:menus
  980. /
  981. /***************** MODE MENU ********************************
  982. /
  983. #:mode
  984. U|Mode menu
  985. T:¯
  986. +: Program Mode
  987. =:prog mode
  988. +: Combination Mode
  989. =:comb mode
  990. +:Internal
  991. =:internal
  992. +:Card
  993. =:card
  994. +: Disable Prog. Mode
  995. =:disable prog
  996. +: Disbale Comb. Mode
  997. =:disable comb
  998.  
  999. /
  1000. /
  1001. #:prog mode
  1002. U|Program Mode
  1003. T:¯
  1004. Switch to the program-librarian. If you're already there, this item is
  1005. disabled. Also if you've 'Disable(d) Prog. Mode' and saved settings one
  1006. of the previous times you ran the program, this item will be disabled.
  1007. Changing modes will take a little time, because the program has to
  1008. initialize and restore various arrays, adapt the resource (all 'sound'-
  1009. text in the menus and dialogs is replaced by 'combi') and update the
  1010. desktop.
  1011.  
  1012. +:Combination Mode...
  1013. =:comb mode
  1014. +:Back to The Menus...
  1015. =:menus
  1016. /
  1017. /
  1018. #:comb mode
  1019. U|Combination Mode
  1020. T:¯
  1021. Switch to the combination-librarian. If you're already there, this item is
  1022. disabled. Also if you've 'Disable(d) Comb. Mode' and saved settings one
  1023. of the previous times you ran the program, this item will be disabled.
  1024.  
  1025. +:Internal...
  1026. =:internal
  1027. +:Back to The Menus...
  1028. =:menus
  1029. /
  1030. /
  1031. #:internal
  1032. U|Internal
  1033. T:¯
  1034. When you have a ROM or RAM card inserted in the M1, you may switch between
  1035. internal memory and card, by selecting either the 'Internal' or 'Card'
  1036. menu options. Note that the mode you're currently in (or rather: the mode
  1037. the M1 is in) will be disabled.
  1038. Switching from Internal to Card and v.v. will erase all programs and combis
  1039. loaded in memory. Therefore you will _always_ be asked to confirm this
  1040. operation, even if all safety options are switched off. Note that the
  1041. clipboard will *not* be erased.
  1042. If you want to exchange sounds between e.g. card and internal memory,
  1043. proceed as follows: put the Bank Manager in 'Card' mode, receive the card-
  1044. sounds in the sounbox, copy them to the clipboard, switch to 'Internal'
  1045. and paste the sounds from the clipboard back to the soundbox. You can now
  1046. send the sounds of your choice to the M1's internal memory.
  1047.  
  1048. +:Card...
  1049. =:card
  1050. +:Back to The Menus...
  1051. =:menus
  1052. /
  1053. /
  1054. #:card
  1055. U|Card
  1056. T:¯
  1057. Well, of course this is the counterpart of the 'Internal' menu item...
  1058. Note that you're allowed to switch to Card mode, even if no card is
  1059. inserted in the M1! You will be able to receive sounds in this case - the
  1060. program will just receive the M1's 'internal' sounds. However, writing
  1061. (= sending) sounds won't be possible. Every attempt to do so will give you
  1062. an error message.
  1063. The reason for this apparent shortcoming is that the M1's sys-ex specs are
  1064. rather vague as to how to detect the presence of a card, and since I don't
  1065. own any cards myself, there was no way to experiment with this part of the
  1066. program.
  1067. Well, I suppose _you_ know if you've got a card inserted or not, so just
  1068. don't switch to 'Card' if there is none...
  1069.  
  1070. +:Disable Prog. Mode...
  1071. =:disable prog
  1072. +:Back to The Menus...
  1073. =:menus
  1074. /
  1075. /
  1076. #:disable prog
  1077. U|Disable Prog. Mode
  1078. T:¯
  1079. Selecting this item permanently disables the program-librarian. You must
  1080. 'Save Settings' and restart in order for your changes to take effect.
  1081. Upon restart, you won't be able to access the program-librarian anymore
  1082. - unless you 'Enable Prog. Mode', save your settings and restart again.
  1083. This option is only useful when you're short on memory: each librarian
  1084. uses its own chunks of memory, so disabling one of the two will nearly
  1085. halve memory usage. In general this shouldn't be a problem since the
  1086. program will run with only 400 kB free memory...
  1087. When you've disabled program mode, the menu-text will change in 'Enable
  1088. Prog. Mode'.
  1089.  
  1090. +:Disable Comb. Mode...
  1091. =:disable comb
  1092. +:Back to The Menus...
  1093. =:menus
  1094. /
  1095. /
  1096. #:disable comb
  1097. U|Disable Comb. Mode
  1098. T:¯
  1099. The same as disabling the program-librarian, but now the combination-
  1100. librarian is disabled. Read the previous page for more details.
  1101.  
  1102. +:*   Safety Menu...   *
  1103. =:safety
  1104. +:Back to The Menus...
  1105. =:menus
  1106. /
  1107. /***************** SAFETY MENU ********************************
  1108. /
  1109. #:safety
  1110. U|Safety menu
  1111. T:¯
  1112. +: Sending
  1113. =:sending
  1114. +: Deletes
  1115. =:deletes
  1116. +: Drag & Copy
  1117. =:drag & copy
  1118. +: Changes
  1119. =:changes
  1120. +: Backups
  1121. =:backups
  1122.  
  1123. /
  1124. /
  1125. #:sending
  1126. U|Sending
  1127. T:¯
  1128. If this item is checked, you are asked if you really want to send sounds
  1129. to the M1 when you select the 'M1/Send Sound(s)', or 'M1/Disk to M1' menu-
  1130. items. This safety-option does not apply to the 'M1/Hear Sound', 'M1/Auto-
  1131. scan ' and 'Options/Autoplay' menu-items, since in these cases no sound is
  1132. *written* to the M1, so you don't run the risk of losing valuable patches.
  1133.  
  1134. +:Deletes...
  1135. =:deletes
  1136. +:Back to The Menus...
  1137. =:menus
  1138. /
  1139. /
  1140. #:deletes
  1141. U|Deletes
  1142. T:¯
  1143. If this item is checked you are asked to confirm every 'File/New' and
  1144. 'Edit/Delete' operation. This does not work on the 'Edit/Remove' option.
  1145.  
  1146. +:Drag & Copy...
  1147. =:drag & copy
  1148. +:Back to The Menus...
  1149. =:menus
  1150. /
  1151. /
  1152. #:drag & copy
  1153. U|Drag & Copy
  1154. T:¯
  1155. When you've checked this item, you will be asked to confirm any copy-
  1156. operation that is invoked by dragging sounds in the soundbox from one
  1157. location to another.
  1158.  
  1159. +:Changes...
  1160. =:changes
  1161. +:Back to The Menus...
  1162. =:menus
  1163. /
  1164. /
  1165. #:changes
  1166. U|Changes
  1167. T:¯
  1168. In case this item is checked, the program keeps track of changes you make
  1169. to the desktop-soundset. If you quit the program while changes have been
  1170. made since the last 'Save' operation, you are notified of this and asked
  1171. if you're sure you want to quit.
  1172.  
  1173. +:Backups...
  1174. =:backups
  1175. +:Back to The Menus...
  1176. =:menus
  1177. /
  1178. /
  1179. #:backups
  1180. U|Backups
  1181. T:¯
  1182. Checking this item causes backup files to be created in case you try to
  1183. save a file under a name that already exists. Backup files have the
  1184. same extension as the original file, only with the last character
  1185. changed to 'B': MPR becomes MPB and MCO becomes MCB.
  1186. So trying to save a file as BASS.MPR while there is already a BASS.MPR
  1187. present, causes this file to be renamed to BASS.MPB before the sounds
  1188. you selected are saved as BASS.MPR.
  1189. Note: an already existing BASS.MPB will be deleted without warning! Also
  1190. since backing-up is *only* done on MPR- and MCO-files, e.g. PRO/COM/GLO
  1191. and SEQ files will also be overwritten without warning!
  1192.  
  1193. +:*   Help Menu...   *
  1194. =:on help
  1195. +:Back to The Menus...
  1196. =:menus
  1197. /
  1198. /***************** HELP MENU ********************************
  1199. /
  1200. #:on help
  1201. U|Help menu
  1202. T:¯
  1203. At startup-time the program tries to load a file 'M1_BANKS.HLP'. If this
  1204. succeeds, the contents of the file can be viewed by pressing HELP or
  1205. selecting the 'Help/Help?' menu-item. If the helpfile is not found, it
  1206. is not loaded <grin...> and no memory for the helpdialog is allocated.
  1207. If you don't need the online-help, rename the file to e.g. M1_BANKS.HLX.
  1208. This will save some meory and speedup the program-startup.
  1209.  
  1210. Since the helpfile is a plain ASCII-file it can be edited with any text
  1211. editor, so you may adapt it to suit your needs. Each page consists of 18
  1212. lines, and 32 pages are allowed. So the maximum number of lines a helpfile
  1213. may contain is 18*32=576. A line may be up to 65 characters long. The format
  1214. of a helpfile is quite simple: all lines are treated as normal text, except
  1215. for the first 18 lines (= the first page). Whenever a line on the first page
  1216. starts with a two digit number and a colon (e.g. '06:'), this line will be
  1217. selectable when the help-dialog is invoked. Selecting this line will
  1218. immediately jump to the page denoted by the number (which, by the way, is
  1219.  
  1220. +:Next Page...
  1221. =:on help2
  1222. /
  1223. /
  1224. #:on help2
  1225. *not* displayed in the dialog). Note that the first page is page 0, whereas
  1226. the first line is line 1! So when you want to be able to jump to an item
  1227. that starts on line 163, which is the first line of page 9 (the tenth page -
  1228. 9*18 + 1), the selectable line should start with '09:'. Lines on the first
  1229. page without a number and colon are treated as plain text.
  1230. I know this method is a bit tedious (I wrote the helpfile myself, so I
  1231. know all about it), but this way it was very easy to implement the help-
  1232. routine, and I don't suppose you'll change the helpfile every few weeks...
  1233.  
  1234. +:* The Icons              *
  1235. =:icons
  1236. +:Back to The Menus...
  1237. =:menus
  1238. /
  1239. /***************** THE ICONS ********************************
  1240. /
  1241. #:icons
  1242. U|The icons
  1243. T:¯
  1244. Many menu-operations can also be performed by dragging or double-clicking
  1245. the icons in the desktop. Proper use of the icons can speed up the process
  1246. of working with the program considerably (that's why they were added in
  1247. version 2.0 :-). In the following, by 'Soundbox' we mean the central 100-
  1248. slot box in which the currently loaded sounds are viewed. Both icons and
  1249. soundbox (or rather: all selected sounds in the soundbox) are dragged by
  1250. pressing the left mouse-button over an icon/a sound and holding it down
  1251. while dragging.
  1252.  
  1253. An overview of the various legal drag and double-click operations, followed
  1254. by their menu-equivalents:
  1255.  
  1256. +:Next Page...
  1257. =:icons2
  1258. /
  1259. /
  1260. #:icons2
  1261. Dragging:
  1262.    DISK to Soundbox:      File/Open with pos...
  1263.    Soundbox to DISK:      File/Save...
  1264.    DISK to TRASH:         File/Delete File...
  1265.  
  1266.    M1 to Soundbox:        M1/Receive Sound(s)
  1267.    Soundbox to M1:        M1/Send Sound(s)
  1268.    M1 to DISK:            M1/M1 to Disk...
  1269.    DISK to M1:            M1/Disk to M1...
  1270.  
  1271.    Soundbox to CLIP:      Edit/Copy
  1272.    CLIP to Soundbox:      Edit/Paste
  1273.    Soundbox to TRASH:     Edit/Delete
  1274.    CLIP to TRASH:         Edit/Clear Clipboard
  1275.  
  1276.    Soundbox to Soundbox:  Copy sounds (no menu-equivalent)
  1277.  
  1278. Double clicking:
  1279.    DISK:                  File/Open...
  1280.    M1:                    M1/Receive Sound(s)
  1281.    CLIP:                  Edit/Set Clipboard...
  1282.  
  1283. +:Next Page...
  1284. =:icons3
  1285. /
  1286. /
  1287. #:icons3
  1288. When you drag the selected sounds and drop them somewhere in the soundbox,
  1289. all selected sounds will be copied to empty locations in the soundbox,
  1290. *beginning* at the slot the mouse was over when you released the mouse-
  1291. button. This can be handy when you e.g. want to move some sounds and don't
  1292. want to use the clipboard (Cut/Paste) for this: select the sounds you want
  1293. to move, drag them to the desired location and release the mouse. After the
  1294. copy-operation is finished, delete the original sounds.
  1295. If the 'Safety/Drag & Copy' item is checked, you will be asked to confirm
  1296. any 'drag and copy' operation.
  1297.  
  1298. +:* Using the Mouse        *
  1299. =:mouse
  1300. +:Home...
  1301. =:main
  1302. /
  1303. /***************** USING THE MOUSE ********************************
  1304. /
  1305. #:mouse
  1306. U|Using the mouse
  1307. T:¯
  1308. The mouse performs various functions:
  1309.  
  1310. Left click:
  1311.  
  1312. - Left click on menu-items to perform the associated action or to 'check'
  1313.   an entry.
  1314. - Left click on a sound in the soundbox to select it.
  1315.  
  1316. Left click & drag:
  1317.  
  1318. - Left click and drag an icon to another icon or to the soundbox to perform
  1319.   the associated action.
  1320. - Left click and drag all selected sounds to an icon to perform the
  1321.   associated action.
  1322. - Left click and drag all selected sounds to another slot in the soundbox.
  1323.   All selected sounds will be copied to empty slots *starting at the slot
  1324.   the mouse was pointing at when you released the button*. When 'Safety/
  1325.   Drag & Copy' is checked, you will be asked to confirm this operation.
  1326.  
  1327. +:Next Page...
  1328. =:mouse2
  1329. /
  1330. /
  1331. #:mouse2
  1332.   Note that there is *no* menu or keyboard equivalent for this action.
  1333. - Left-click & drag not on a sound or icon. A rubberbox will appear. All
  1334.   sounds (partially) in the rubberbox will be selected.
  1335.  
  1336. Left click, press SHIFT & drag:
  1337.  
  1338. - Left-click in the soundbox and drag, while pressing either SHIFT-key to
  1339.   'drag-select' or 'drag-deselect' several sounds, without releasing the
  1340.   mousebutton.
  1341. - Left click on a sound and drag all selected sounds to an icon to perform
  1342.   the associated action.
  1343. - Left-click, press SHIFT & drag not on a sound or icon. A rubberbox will
  1344.   appear. All sounds (partially) in the rubberbox will be deselected.
  1345.  
  1346. Double left click:
  1347.  
  1348. - Double click on icons to perform the associated action.
  1349. - Double click on a (non-empty) sound in the soundbox to rename it.
  1350.  
  1351. +:* Using the Keyboard     *
  1352. =:keyboard
  1353. +:Home...
  1354. =:main
  1355. /
  1356. /***************** USING THE KEYBOARD ********************************
  1357. /
  1358. #:keyboard
  1359. U|Using the keyboard
  1360. T:¯
  1361. Most of the menu-options can also be choosen by pressing a certain key-
  1362. combination. The key-combinations associated with a certain menu-option
  1363. are displayed in the menus at the right side of the entry. Most keyboard
  1364. shortcuts consist of the CONTROL key together with a letter, except for the
  1365. 'Edit/Insert', 'Edit/Delete, 'Help/Help?' items, which are invoked by
  1366. pressing the Insert, Delete and Help keys respectively. The shortcuts for
  1367. the 'M1'-menu consist of a combination of the ALTERNATE key and a letter.
  1368.  
  1369. The three 'File/Open' menu-items can also be selected while additionally
  1370. holding down either SHIFT key (or by mouse-selecting the entry while
  1371. holding down either SHIFT key). When a SHIFT key is pressed, the file
  1372. selector will show not only files of the current filetype (MPR or MCO,
  1373. depending on whether you're in program or combi mode), but also the backup
  1374. files of the current type (MPB or MCB). This enables you to choose and load
  1375. backup-files. So, as an example: CONTROL-O selects 'Open...', while CONTROL-
  1376. SHIFT-O selects 'Open any file...', etc. Note that normally, when not
  1377. pressing a SHIFT key, the program automatically adds the right extension to
  1378. the file you choose. When pressing SHIFT and opening a file however, the
  1379.  
  1380. +:Next Page...
  1381. =:keyboard2
  1382. /
  1383. /
  1384. #:keyboard2
  1385. program will not do this - it is thus necessary to enter a complete and
  1386. correct filename.
  1387.  
  1388. Other keyboard operations:
  1389.  
  1390. Typing a number between 0 and 99, followed by a RETURN, will (de)select the
  1391. correspondng slot in the soundbox. Pressing ESCAPE or UNDO instead of RETURN
  1392. aborts this operation. Note that the numeric keypad doesn't work - you have
  1393. to use the top numerical key-row. Numbers 0-9 may be entered as either '0x'
  1394. or 'x'.
  1395.  
  1396. Function keys F1-F5 (de)select an entire column of sounds (20 sounds). F1
  1397. (de)selects sounds 00-19, F2 (de)selects 20-39, etc. Whether a column is
  1398. selected or deselected depends on the status of the first sound in the
  1399. column: if it is selected, pressing the corresponding F-key will deselect
  1400. the entire column; if it's deselected pressing the corresponding F-key will
  1401. select the entire column.
  1402.  
  1403. +:Limitations...
  1404. =:limitations
  1405. +:Home...
  1406. =:main
  1407. /
  1408. /
  1409. /
  1410. #:limitations
  1411. U|Limitations
  1412. T:¯
  1413. Since the Bank Manager is written in Omicron Basic, it probably isn't too
  1414. system-friendly - I can't help it, the problem is in the rather broken
  1415. Omicron Compiler (v.3). However, on normal STs it should run without
  1416. problems. Since I haven't been able to test it on color monitors, I don't
  1417. know what happens in medium resolution. I'm sure it won't run in low-rez,
  1418. since the dialogs and desktop are too big to fit on a low-rez screen.
  1419. In medium-rez (provided it runs at all...) the dialogs and desktop will
  1420. probably be a mess due to alignment problems (how else could I cram all
  1421. this info on one screen... ?).
  1422. The program uses as little memory as possible, so in normal use it should
  1423. give you no memory-problems. If it does, try disabling one of the BM's
  1424. librarians (although I can't imagine it to be necessary).
  1425.  
  1426. Other limitations...? Let me know.
  1427.  
  1428. +:Next Page...
  1429. =:lim2
  1430. /
  1431. /
  1432. /
  1433. #:lim2
  1434. Known bugs:
  1435.  
  1436. - When 'Auto deselect' is off, sometimes a spurious mouse-event is
  1437.   generated, causing the slot above which you released the mouse (e.g.
  1438.   when dragging an icon to the soundbox) to be deselected. Haven't been
  1439.   able to fix this one...
  1440. - Keeping one of the Function-keys pressed will eventually crash the
  1441.   program (??? lots of time spent on this bug, but still haven't been
  1442.   able to fix it).
  1443.  
  1444. +:Copyright & Disclaimer
  1445. =:copyright
  1446. +:Home...
  1447. =:main
  1448. /
  1449. /***************** COPYRIGHT & DISCLAIMER **************************
  1450. /
  1451. #:disclaimer
  1452. U|Disclaimer
  1453. T:¯
  1454. Because you haven't paid a dime for it, the author and So What? software
  1455. don't take any responsibility  for any damage real or perceived, caused or
  1456. not caused by this program. We don't mind how bad you f*ck up your hard
  1457. disk, your computer, your M1, your man or wife or favourite pet: we are not
  1458. to blame, not even in case of loss of files, loss of lifes, lethal explosion
  1459. of your system, fire, third world war, or whatever.
  1460. This software is delivered 'as is' and free of known bugs (except for the
  1461. ones listed above) and it is solely your responsibility if you don't know
  1462. how to use it properly. And even if you know how to use it properly, it's
  1463. solely your responsibility that you use the program at all. We think you
  1464. got a nice piece of software for an absolute minimum price, so don't bother
  1465. us with complaints.
  1466.  
  1467. As always, serious bug reports or suggestions for improvements are more
  1468. than welcome of course. If you send a bug report together with a self-
  1469. addressed, stamped envelope and formatted (DD) disk, I'll send you the
  1470. debugged version of the program. Make sure that your bug report contains
  1471. enough information for me to be able to reproduce the bug.
  1472.  
  1473. +:Copyright...
  1474. =:copyright
  1475. /
  1476. /
  1477. /
  1478. #:copyright
  1479. U|Copyright
  1480. T:¯
  1481.  
  1482. The program and it's source are copyrighted (C) 1990/1992 by
  1483. * So What? * software. You are however permitted to make copies
  1484. of the program and give them away or put them on bulletin boards,
  1485. provided no changes were made to the original files - we don't
  1486. want to receive complaints because some dude messed up a
  1487. resource file, or because the documentation is missing.
  1488.  
  1489. The source code is *not* available.
  1490.  
  1491. +:Final Remarks
  1492. =:final
  1493. +:Home...
  1494. =:main
  1495. /
  1496. /***************** FINAL REMARKS ********************************
  1497. /
  1498. #:final
  1499. U|Final remarks
  1500. T:¯
  1501. Enjoy the M1 Bank Manager!
  1502. If you want to send me
  1503. 1. a postcard, telling me how absolutely marvelous the program is;
  1504. 2. suggestions for next versions (more options? tell me and I'll consider
  1505.    them seriously);
  1506. 3. high quality soft drugs;
  1507. 4. good looking, unmarried young daughters;
  1508. 5. large amounts of money;
  1509. then use the address below. If you've got any comments, bug reports,
  1510. suggestions for future versions, or whatever, let me know. I've tried -
  1511. and will continue trying- to make this program as fool-proof and bug-free
  1512. as possible, but I need you, the user, to know what bugs are left and what
  1513. features you'd like to see in future versions.
  1514. I don't expect to receive any money for this program, but I would very much
  1515. appreciate receiving any patches you made for your M1. I spent months
  1516. writing this program, and I provided you with tons of sounds for your M1,
  1517. so do I really ask too much? Watch your BBS and the various Atari archives
  1518. for new versions of this program!
  1519.  
  1520. +:Next Page...
  1521. =:final2
  1522. /
  1523. /
  1524. #:final2
  1525. The program you started to read this documentation was written with the
  1526. help of the Pure-C HELP-library - another marvelous So What? product.
  1527. Sources and executables of this lib and the accompanying programs are
  1528. completely public domain - check your local BBS or the various atari
  1529. archives!
  1530.  
  1531.   I can be reached at:
  1532.  
  1533.   snailmail:                 email:
  1534.  
  1535.   Hendrik Jan Veenstra       Internet:  hjv@phil.ruu.nl
  1536.   Lepelaarstraat 27
  1537.   3582 SL   Utrecht          SterBBS (the largest ST bbs):
  1538.   The Netherlands            01880 - 40035    user_ID: hjv
  1539.  
  1540.  
  1541. And remember: the purpose of this program is solely to speed up
  1542. non-relevant work, so you'll have more time free to write good
  1543. music.
  1544.  
  1545. +:Home...
  1546. =:main